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PREFACE 



This manual describes the user utilities available with TOPS-10. The 
program descriptions are arranged alphabetically. 

Before you read this manual, you should be familiar with TOPS-10 
command usage, file specifications, and terminology. If you need to 
refer to any of the elements of the TOPS-10 command environment, read 
Chapter 1 of the TOPS-10 Operating System Commands Manual . Before you 
attempt to use the programs described in this User Utilities Manual, 
you must be familiar with the following concepts: 

o monitor and user levels 

o special control characters 

o switches and arguments 

o file specifications 

o device names 

o wildcard constructions 

o search lists and directory paths 

CONVENTIONS USED IN THIS MANUAL 

The following conventions are used in this manual: 

Convention Meaning 

addr Program or location address. 

arg An argument to a command. 

core Referring to main (processor) memory. 

CTRL/x A control character. 

date A date in the form of two digits for the day, three 

letters for the month, and two digits for the year. 
(For example, 22-AUG-86 represents August 22, 1986.) 

date-time The date and time in the standard format. For example, 
13-SEP-86: 13:00:00 represents September 13, 1986 at one 
p.m • . 

density The density of a magnetic tape. 



Convention 



Meaning 



dev : 

device-name 

devnn 

devnnu 

devu 

[directory] 
[dir] 

expression 

file .ext 

file name 
file-spec 

fs 

hh :mm:ss 

id 

job 

jobname 

letter 

line-number 

list 

logical-name 

log-rname 

log 

memory 



MFD 

<nnn> 

nnnn 

n 

"name* 

nodelist 

PPN 

program 

proj,prog 



Any logical or physical device name. (You must include 
a colon (:) when a device name is part of a 
file specification.) 



A directory name. This can be either a UFD or an SFD. 

A numeric expression. 

A file name and a file extension, separated by a 
period . 

A name of a file. 

A file specification written in the format: 
dev :f ile.ext[directory] . 

File structure. 

The time of day using a 24-hour clock, where hh is 
hours, mm is minutes, and ss is seconds. 

An identifier. 

A job number. 

The name of the job. 

An alphabetic character. 

Referring to the number of the line. 

A list of arguments. 

A logical device name, chosen by the user. 



The decimal number of memory words measured in K or P. 
(IK is equal to 1024 words; IP (page) is equal to 512 
words.) 

A master file directory. 

A protection code. 

A tape density. 

A decimal number, such as a unit number. 

A DECtape identifier. 

A list of all the systems in a network environment. 

A project-programmer number. 

A program name. 

A project-programmer number. 



vi 



Convention 

[proj ,prog] 

SFD 

spec 

str 

/switch 

time 

UFD 

v 

x 

$ 



<CTRL/x> 

<DEL> 

<RET> 
<ESC> 



Meaning 

The name of a user-file directory. 

A sub-file directory . 

A specification of a file. 

A file structure name. 

A command line modifier. 

Referring to a time of day. 

A user-file directory. 

Version number. 

A numeric or text variable. 

The symbol printed on your terminal when you press the 
ESCape (or ALTmode) key. 

A character that is printed when you press the CONTROL 
key while you type a character key. (For example, 
typing a CTRL/C prints "C at your terminal.) 

Indicates that you should press the CONTROL key at the 
same time as the key indicated here by "x". 

Indicates when you should press the DELETE or RUBOUT 
key. 

Indicates when you should press the RETURN key. 

Indicates when you should press the ESCape (or ALTmode) 
key. 



All examples, commands, switches, values, and arguments are shown in 

uppercase. This is for the sake of distinction. Examples are shown 

as they would appear on a terminal that does not have lowercase 
ability. 
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CHAPTER 1 
SAVING AND RESTORING FILES USING BACKUP 



Function 

The BACKUP program saves disk files on magnetic tape and places all or 
some of these files back onto the disk. You can save your disk area 
on magnetic tape and restore all of your files or a subset of your 
files back to your area. You can also use this program to move your 
files from one system to another. Please refer to the TOPS-10 
Operator 1 s Guide for detailed information about the BACKUP program. 

Format 

R BACKUP 
/command 

where: command is one of the BACKUP commands, which are in verb form. 
BACKUP prompts with a slash (/) , after which you respond with 
one of three command types: 

o Action command 

o Status-setting command 

o Tape-positioning command 



Action Commands 

Action commands perform I/O on the tape specified in the last TAPE 
command. You must specify a tape using the TAPE command before you 
use an action command. TAPE is described under the status-setting 
commands for BACKUP. 



SAVE file-spec 



RESTORE file-rspec 



CHECK file-spec 



[N] PRINT file-spec 



Saves the specified disk files on 
tape. 

Restores the specified tape files 
to disk. 

Verifies that the tape and the disk 
files are the same. 

Prints a directory of the entire 
tape specified by file-spec. N is 
an optional prefix indicating 
narrow. PRINT implies a 
NODIRECTORIES command; that is, no 
user directory names are printed. 
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The file-spec arguments are optional. File specifications may have 
wildcards. You can specify input and output files in the form 
output=input , or you can specify input alone. Use commas to separate 
file-spec entries in a list. 

If you do not supply an argument with an action command, BACKUP 
defaults to a file-spec as follows: 

o For anyone logged-in under [1,2], the default file spec is 
ALL:*.* [*,*,*,*,*,*,*]. This specifies all files on all 
UFDs, and all SFDs of all file structures, with no renaming. 

o For all other users, the default file spec is ALL:*.* 
[PPN,* ,* ,* ,*,*] where PPN is the user's PPN. This specifies 
all files in the user's areas should be saved with a disk 
structure specified, and restored to the appropriate 
structure. 



Action Command Switches 

You can use the following switches in the file specification list for 
the action commands. These switches can be either permanent or 
temporary. Input files are those being transferred from disk to tape. 
Output files are those being transferred from tape to disk. 



/ABEFORE date 
/ASINCE date 
/BEFORE date-time 

/ERNONE 

/ERPROTECTION 

/ERSUPERSEDE 

/ESTIMATE n 
/LENGTH low:high 

/MBEFORE nD:hh:mm:ss 
/MSINCE nD:hh:mm:ss 
/NOPHYSICAL 



On input file, includes only files 
accessed before the specified date. 

On input file, includes only files 
accessed since the specified date. 

On input file, includes only files 
created before the specified 
date-time. 

On input file, gives an error if no 
files match. 

On input file, gives an error if 
there is a protection failure. 

On output file, does not restore a 
file from tape if it already exists 
on disk. 

On output file, estimates output 
size (n) . 

On input file, includes the file 
only if file length is between low 
(minimum file size) and high 
(maximum file size) . 

On input file, includes only files 
modified before date-time. nD 
represents the number of days. 

On input file, includes only files 
modified since date-time. nD 
represents the number of days. 

On input or output file, uses the 
logical names. 
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/OKNONE 

/OKPROTECTION 

/OKSUPERSEDE 

/PHYSICAL 
/PROTECTION nnn 
/SINCE date-time 

/STRS 
/VERSION v 



On input file, does not give an 
error if no files match your file 
specification. 

On input file, does not give an 
error if there is a protection 
failure. 

On output file, always restores the 
file, even if the file is already 
on disk. 

On input or output file, ignores 
any logical names. 

On output file, sets the protection 
code. 

On input file, includes only those 
files created since the specified 
date-time. 



On input file, examines 
structures for the file. 



all 



On output file, sets the version 
number of the file. 



Runtime Commands 

You can issue the following runtime commands during the execution of 
any action commands. BACKUP prompts with an exclamation point (!) 
when ready to accept a runtime command. 



DIRECTORIES 

EXIT 

FILES 

GO 
HELP 

KILL 

NODIRECTORIES 

NOFILES 



Prints every directory processed. 

Exits from BACKUP when done. 

Prints every file and directory 
processed. 

Continues after a STOP. 



Lists BACKUP 
explanations. 



commands 



and 



PAUSE 



RESET 



SILENCE 



Aborts execution of the current 
action verb. 

Does not print every directory 
processed. 

Does not print every file in every 
directory processed. 

Does not exit from BACKUP when 
done. 

Resets all status settings to their 
original defaults when done. 

Stops printing every directory or 
file. 
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STOP 



WHAT 



Stops action temporarily; can be 
continued by GO. 

Displays current file name and 
status. 



Status-Setting Commands 

Status-setting commands 
future action commands. 

ABEFORE date 



APPEND 
ASINCE date 

BEFORE date-time 

CPOINT 
DATE 7 5 

DELETE 

DENSITY nnnn 

DIRECTORIES 
ENCRYPT 

ERRMAX n 
EXEMPT 

FILES 

INITIAL file 
INTERCHANGE 



specify one or more parameters that affect 



Includes only files accessed before 
the specified date. 

Appends to the existing list file. 

Includes only the files accessed 
since the specified date. 

Includes only the files created and 
modified before the specified 
date-time. 

Uses checkpoints. 

Always accepts files with possible 
DATE75 problems. 

Deletes disk files after saving 
them. 

Sets the tape density. The 

density, expressed in bits per inch 

(bpi) , can be 200, 556, 800, 1600, 
or 6250. 

Prints each user's directory while 
running. 

Encrypts (codes) the files. This 
makes the files impossible to read 
without the keyword. 

Set maximum number of recoverable 
tape errors. Default is 100. 

Exempts project-programmer numbers 
of the form [A,*] and [*,B], where 
A and B are less than 7, from date, 
time, and length restrictions. 

Prints each file name while 
running. 

Starts processing at the specified 
file. 

Runs in interchange mode. 
Interchange is used to copy files 
from one installation to another 
with no directory dependencies. 
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LENGTH lowrhigh 



LIST file-spec 



MBEFORE date-time 

MESSAGE [NO] PREFIX 
MESSAGE [NO] FIRST 
MSINCE date-time 

MULTIREEL 

NOAPPEND 

NOCPOINT 
NODATE75 

NODELETE 

NODIRECTORIES 

NOENCRYPT 
NOEXEMPT 

NOFILES 

NOINTERCHANGE 
NOLIST file 
NOMULTIREEL 

NOREPEAT 

NOUSETI 
NOWRITE 



Includes only files whose length is 
between low (minimum file size) and 
high (maximum file size). 

While running, creates a listing 
file on file-spec. LIST produces 
the effect of a NODIRECTORIES 
command; that is, no user 
directories will be printed. 

Includes only files that were moved 
or modified before the specified 
time. 



Suppresses the 
prefix. 



error 



message 



Suppresses the first line of the 
error message text. 

Includes only files that have been 
moved or modified since the 
specified time. 

Allows multiple reels during a 
save. 

Does not append to the existing 
list file. 

Does not use checkpoints. 

Does not accept files with possible 
DATE75 problems. 

Does not delete disk files after 
saving them. 

Does not print each user's 
directory while running. 

Does not encrypt (code) the files. 

Does not exempt PPNs of [A,*] and 
[*,B] from restrictions. 

Does not print each file while 
running. 

Does not run in interchange mode. 

Does not make a listing file. 

Does not allow multiple reels 
during the save. 

Does not repeat a split file on the 
continuation tape. 

Does not run in USETI mode. 

Suppresses disk writing during a 
restore. 
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OPTION name 

PARITY (EVEN, ODD) 
REPEAT 

RESUME n 

SILENCE 

SINCE date-time 

SORT DIRECTORIES X 

SORT FILES x 

SSNAME name 
SUPERSEDE ALWAYS 

SUPERSEDE NEVER 
SUPERSEDE OLDER 



TAPE MTxn: 



TPNUM x 



UPROTECTION nnn 



WRITE 



Uses line BACKUP:name from 
SWITCH.INI file. 

Sets the tape parity. 

Repeats a split file on 
continuation tape. 



the 



Sets a checkpoint block number 
where processing resumes after a 
crash that occurred during a 
checkpointed SAVE or RESTORE. 



Does not print file names 
directories while running. 



or 



Includes only those files created 
or modified since the specified 
date-time. 

Sorts directories within each file 
structure in order of x when 
saving. x is ALPHABETICAL, 
LOCATION, or NONE. 

Sorts files within each directory 
in the order of x. x is 
ALPHABETICAL, LOCATION, or NONE. 

Specifies the save-set name. Use 
ALL to include all save-sets. 

Restores all files from tape, 
superseding files on disk that have 
the same file name. 

Does not restore files that have 
the same name as an existing file. 

Restores only the files that are 
newer than the files on disk of the 
same name. 

Uses tape unit MTxn:. If a 
magnetic tape drive has the logical 
name BACKUP, then the TAPE verb 
need not be specified. 

Sets the number of the tape to x 
(decimal) . 

Sets the protection code for the 
created directories. 

Writes onto disk during a RESTORE. 
This is the default action. 
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Tape-Positioning Commands 

Use these commands before action commands or after action commands are 
finished processing. 



EOT volid-list 



REWIND volid-list 
SKIP n volid-list 

SKIP volid-list 

SKIP -n volid-list 

UNLOAD volid-list 



Skips to the end-of-tape mark for 
each tape in the list. The 
volid-list is a list of the 
volume-identifications of each 
tape . 

Rewinds to the beginning of the 
tape for each tape in the list. 

Skips the specified number of save 
sets forward for each tape in the 
list. 

Backs up to the start of the 
current save set for each tape in 
the list. 

Skips the specified number of save 
sets backward for each tape in the 
list. 

Unloads each tape in the list from 
its drive. 



Characteristics 
The BACKUP program: 

Places your terminal at user level. 

Destroys your core image. 
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Examples 



1. To save the entire contents of DSKB: on magnetic tape and at 
the same time produce a directory listing, run BACKUP while 
logged in under [1,2]. 

.R BACKUP<RET> 
/TAPE MTA0<RET> 
/LIST DSK: BACKUP. LOG<RET> 
/SAVE DSKB:<RET> 
!1,2 DSKB 
1,3 
1,4 



BACKUP prints each UFD as it begins to save files from v that 
area. If the tape becomes full before the save is complete, 
BACKUP stops, types out the full file specification and block 
number of the current file being saved, unloads the magnetic 
tape and prints the following message: 

$BKPEOT REACHED EOT — MOUNT NEW TAPE THEN TYPE "GO" 

When you type GO, BACKUP continues the save on the new tape. 
A file can be split across tapes. 

2. Copy the file FILE. MAC from tape to disk. 

.R BACKUP<RET> 
/TAPE MTB0<RET> 
/REWIND<RET> 
' /RESTORE FILEB.MAC=FILEA.MAC<RET> 
110,123 DSKB 
DONE 
/UNLOAD<RET> 
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CREATING DIRECTORIES AND SUB-FILE DIRECTORIES USING CREDIR 



Function 

The CREDIR program creates directories and sub-file directories. 
CREDIR creates sub-file directories (SFDs) on any specified 
structures, and it automatically creates any necessary higher-level 
directories. If you do not specify a structure, CREDIR creates the 
SFD on every structure in your search list. 

You can use CREDIR to create ersatz device directories. CREDIR allows 
you to create directories on all structures associated with a 
specified ersatz device. As it creates each directory, CREDIR tells 
you the name of the unit and the protection code associated with the 
directory. 



Format 

R CREDIR 

Create directory: dev : [di r] /switch 

where: dev:[dir] is the device name and the directory specification. 
You can specify an ersatz device name, /switch can be any of 
the switches listed below. 

By default, CREDIR creates the directory on device DSK:. The 
system assigns the default protection code defined by the 
system manager. If no code was defined, <775> is the default. 

You can use the following switches to modify the CREDIR 
program: 



/ALLOCATE :nnnn 

/ERNONE 

/ERPROTECTION 

/HELP:arg 
/IN:nnnn 



Specifies the number of blocks 
allocated for the SFD. 

Prints an error message if there 
are no files in the request. 

Prints an error message if the 
request fails due to a 
protection code violation. 

Prints the HELP text for the 
CREDIR program. You can specify 
S as the argument to get a list 
of the switches to the program. 

Specifies the logged-in quota. 
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/NAME: name 
/NOOPTION 

/OKNONE 

/OKPROTECTION 

/OPTION :name 

/OUTinnnn 
/PHYSICAL 

/PROTECTION:nnn 
/RUN: file-spec 

/RUNCOR:n 

/RUNOFFSET:n 



/STRS 



Specifies a mnemonic name for 
the directory. 

Suppresses processing of the 
defaults from your SWITCH.INI 
file. 

Does not print an error message 
if there are no files that match 
a wildcard specification. 

Does not print an error message 
if the SFD cannot be accessed 
because of a file protection 
violation. 

Uses any lines in your 
SWITCH.INI file that are 
specified as CREDIR:name. 

Specifies the logged-out quota 
for the SFD. 

Specifies that the device name 
is physical, and to ignore 
logical names. 

Gives the SFD the protection you 
specify in nnn. 

Runs the program you specified 
when CREDIR has finished 
running. 

Runs the program you specified 
with /RUN in nK of memory when 
CREDIR has finished running. 

Runs the program you specified 
with /RUN with an offset of n. 
If you omit the switch, the 
default is 0. If you specify 
the switch, but omit a value for 
n, the default is 1. If the 
offset is 1, the file uses an 
indirect command file. 

Searches for the SFD in all 
structures in your job's search 
list, and uses every occurrence. 



Characteristics 
The CREDIR program: 

Destroys your core image. 

Requires LOGIN. 

Places your terminal at user level. 
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Examples 



1. The following example shows the creation and use of an SFD 
and directory paths. 

Show a list of all the files in your UFD with a file 
extension .TST. 



.DIRECT *.TST<RET> 



NUMB 


TST 





<055> 


dd-mmm-yy 


109 


TST 


5 


<055> 


dd-mmm-yy 


FILL 


TST 


1 


<055> 


dd-mmm-yy 


PAY 3 


TST 


1 


<055> 


dd-mmm-yy 



DSKC: [27,5434] 



TOTAL OF 7 BLOCKS IN 4 FILES ON DSKC: [27,5434] 

Run the CREDIR program. Create a sub-file directory called 
TEST. Use the /EXIT switch to exit from CREDIR. 

.R CREDIR<RET> 

Create directory: [27, 5434, TEST] <RET> 

CREATED DSKC: [27, 5434, TEST] .SFD/PROTECTION: 775 

Create directory: /EXIT 

Request a list of all your files named TEST. 

.DIR TEST.*<RET> 

TEST FOR 1 <055> dd-mmm-yy DSKC: [27,5434] 
TEST SFD 1 <775> dd-mmm-yy 

TOTAL OF 2 BLOCKS IN 2 FILES ON DSKC: [27,5434] 

The directory shows an SFD named TEST. 

Use RENAME to transfer all files with the extension .TST from 
your UFD to your SFD. 

.RENAME [27, 5434, TEST] =*.TST<RET> 

FILES RENAMED: 

DSKC: NUMB. TST 

DSKC: 109. TST 

DSKC:FILL.TST 

DSKC: PAY 3. TST 

Show that your UFD no longer contains the files with the 
extension .TST. 

.DIR *.TST<RET> 

%WLDNSF No such files as DSKC:* .TST[27, 5434] 

Show that the files have been transferred to the SFD 
[27, 5434, TEST] . 

.DIR [27,5434,TEST]<RET> 

NUMB TST <055> dd-mmm-yy DSKC: [27, 5434, TEST] 

109 TST 5 <055> dd-mmm-yy 

FILL TST 1 <055> dd-mmm-yy 

PAY3 TST 1 <055> dd-mmm-yy 

TOTAL OF 7 BLOCKS IN 4 FILES ON DSKC: [27, 5434, TEST] 
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2. The following example shows the use of CREDIR with 
switch /PROTECTION. 



the SCAN 



.R CREDIR<RET> 

Create directory: DSKB: [ , , A,B,C]/PROTECTION: 755<RET> 
CREATED DSKB: [27, 4072, A] .SFD/PROTECTION: 755 
CREATED DSKB: [27 , 4072, A, B] . SFD/PROTECTION: 755 
CREATED DSKB: [27 , 4072, A, B,C] . SFD/PROTECTION: 755 

Create directory: /EXIT 
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CHAPTER 3 
GETTING CROSS-REFERENCE LISTINGS USING CREF 



Function 

The CREF program produces a sequentially numbered assembly listing of 
a program, and one or more of the following tables: 

o Cross reference table for all operands, such as labels and 
assignments 

o Cross reference table for all user-defined operators, such as 
macro calls and OPDEFs 

o Cross reference table for all op codes and pseudo-ops. You 
must specify the /0 switch to produce this table. 

The cross-reference files are printed on the line printer if you have 
generated such files using the /CREF switch with a COMPILE, LOAD, 
DEBUG, or EXECUTE command. The file containing the names of these 
CREF files is then deleted so that subsequent CREF commands will not 
process them again. 

When the logical device name LPT: is assigned to a device other than 
the line printer, the CREF files are stored on that device with the 
same file name and the extension .LST. If output to the line printer 
is not currently spooled, you must set spooling before running CREF 
(see the SET SPOOL command in the TOPS-10 Operating System Commands 
Manual ) • 

Formats 

R CREF/switch 
* file spec 

CREF file-spec/switch 

where: file-spec is a valid file specification. When you supply a 
file specification, CREF produces a cross-referenced listing 
file for the specified file. If you do not give an argument 
to the command, CREF uses the argument saved from a previous 
COMPILE-class command. CREF prompts with an asterisk (*) when 
you use the R CREF command or if there is no stored argument, 
/switch is one or more of the following switches: 

/A Advances magtape by one file (may be repeated) . 

/B Backspaces magtape by one file (may be repeated) . 

/C Cancels SWITCH.INI switch defaulting. 
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/D Permits default switches you specified in your 
SWITCH.INI file. 

/H Types the HELP text for CREF. 

/K Does not list user-defined symbol tables. 

/M Suppresses user macros, OPDEFs, and symbol table. 

/0 Lists the opcodes. 

/P Preserves (does not delete) input files. 

/R Restarts listing and prompts for line number. 

/S Suppresses program listing and lists only symbol 
tables. 

/W Rewinds tape. 

/Z Deletes the current contents of the DECtape directory. 

Characteristics 
The CREF program: 

Leaves your terminal at monitor level. 

Destroys your core image. 

Requires LOGIN. 

Examples 

1. Compile the files contained in the command file PROMAC and 
produce CREF listing files on the disk. 

.COMPILE/CREF@PROMAC<RET> 

FORTRAN: INPUT1 

MAIN. 

FORTRAN: INPUT2 

MAIN.. 

Process and list the cross-referenced listing files produced 
by the COMPILE command. The argument is the stored argument 
that was used in the COMPILE command. 

.SET SPOOL LPT<RET> 
.CREF<RET> 
CREF:INPUT1 
CREF:INPUT2 
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2. Compile and load the files contained in the command file 
CONALL. Produce a loader map with the file name NAME and 
CREF files on disk. 

. LOAD/CREF/MAP:NAME@CONALL<RET> 
MACRO: HIGH 
MACRO: SHARE 
EXIT 

Assign the logical name LPT to magnetic tape unit 1. Store 
the CREF files on MTA1: to be output at a later time. 

.ASSIGN MTA1 LPT<RET> 
MTA261 ASSIGNED 

,CREF<RET> 
CREF: HIGH 
CREF: SHARE 
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CHAPTER 4 
COMPARING FILES USING FILCOM 



Function 

The FILCOM program compares two files and displays any differences. 
Generally, this comparison is line-by-line for ASCII files and 
word-by-word for binary files. FILCOM determines the type of 
comparison to use by examining either the switches specified in the 
command string or the extensions of the files. Switches always take 
precedence over file extensions. 

Format 

R FILCOM 

*output-file-spec= input-file-spec, input-file-spec/switch 

where; * is the FILCOM prompt, file-spec is a valid file 
specification, output-file-spec specifies the name and area on 
which the results should be stored, and input-file-spec is a 
list of the files to be compared. 

The FILCOM program takes the following defaults if you omit some of 
the above information; 

o If you omit the output specification, the output device is 
assumed to be TTY;. If you omit the output file 
specification, you must still type the equal sign. 

o If you specify only the output file name, the default output 
device is DSK; . 

o If you omit the output file name, the second input file name 
is used, unless it is null. In this case, the file name 
FILCOM is used. 

o If you omit the output file extension, .SCM is used on a 
source compare and .BCM is used on a binary compare. 

o If you omit the [directory] in either the input or output 
file specifications, your default directory is assumed. 

o If you omit an input device name, it is assumed to be DSK;. 

o If you omit the file name of the second input file, it is 
taken from the first input file. 



4-1 



COMPARING FILES USING FILCOM 

o You must place a dot following the file name of the second 
input file to explicitly indicate a null extension if the 
extension of the first input file is not null. For example, 
to compare FILE. MAC and FILE. (that is, with null 
extension), use the following command string: 

R FILCOM<RET> 
*=FILE. MAC, FILE. 

o The second input file specification cannot be null unless a 
binary compare is being performed. In a binary compare, if 
the first input file is not followed by a comma and a second 
input file descriptor, the input file is compared to a zero 
file and is output in its entirety. This gives you a method 
of listing a binary file. (Refer to Example 4.) 

/switch is one of the options listed below. A switch can follow the 
input file-specs. The following switches are used for a binary file 
comparison : 

/E Creates file in executable format. 

/H Prints a list of switches available (help text 

from device HLP:). 

/nL Specifies the lower limit for a partial binary 

compare (n is an octal number) . This switch, when 
used with the /nil switch, allows a binary file to 
be compared only within the specified limits. 

/Q Prints the message ?FILES ARE DIFFERENT when the 

files are different, but does not list the 
differences. This switch is useful when you test 
batch control files for differences but do not 
want a log file of these differences. 

/nU Specifies the upper limit for a partial binary 

compare (n is an octal number). This switch, when 
used with the /nL switch, allows a binary file to 
be compared only within the specified limits. 

/W Compares files in binary mode without expanding 

the files first. This switch is used to compare 
two binary files with ASCII extensions. 

/X Expands .SAV files before comparing them in binary 

mode. This action removes differences resulting 
from zero compression. 

If you did not specify any switches in the command string, FILCOM 
compares the files in the mode the extension implies. FILCOM 
recognizes the following extensions as binary: 



.APL 


.ATR 


.BAC 


.BIN 


• BUG 


.CAL 


.CHN 


.DAE 


.DBS 


.DCR 


• DMP 


.EXE 


.HGH 


♦ LOW 


.MSB 


.OVL 


• QUC 


• QUD 


.QUE 


.QUF 


.REL 


.RIM 


.RMT 


.RTB 


.SAV 


.SCH 


.SFD 


.SHR 


.SVE 


.SYM 


.SYS 


.UFD 


.UNV 


.XPN 
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Binary files are compared word by word, starting at word 0, except for 
the following cases: 

o Files with extensions .SHR and .HGH are assumed to be 
high-segment files. Because the word count starts at 400000, 
upper and lower limits, if used, must be greater than (or 
equal to in the case of the lower limit) 400000. 

o Files with extensions .SAV, .LOW, and .SVE are assumed to be 
compressed core image files and are expanded before 
comparing . 

o Files with the extension .EXE are assumed to be in .EXE 
format. 

Conflicts are resolved by switches or defaults. If a conflict arises 
in the absence of switches, the files are assumed to be ordinary 
binary files. 

The following switches are used for an ASCII source file comparison: 

/A Compares files in ASCII mode. This switch is used 

to force comparison of two files to be done in 
ASCII. 

/B Compares blank lines. Without this switch, blank 

lines are ignored. 

/C Ignores comments (all text on a line following a 

semicolon) and spacing (spaces and tabs). A line 
consisting entirely of comments or spacing is not 
treated as if it were a blank line; differences in 
such lines are not ignored. 

/H Prints a list of switches available (help text 

from device HLP:). 

/nL Specifies the number of lines that determine a 

match (n is an octal number) . A match means that 
n successive lines in each input file have been 
found to be identical. When a match is found, all 
differences occurring before the match and after 
the previous match are listed. In addition, the 
first line of the current match is listed after 
the differences, to help you locate the place 
within each file at which the differences 
occurred. The default value for n is 3. 
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/O Instructs FILCOM to include a label and offset in 

the differences listing for ASCII files. There 
are three types of messages. One message is: 

[;At top of file + nL] 

nL, a decimal number, represents the number of 
lines from the top of the file that the difference 
occurs. If a difference occurs at the top of the 
file, nL is not listed. Another message is: 

[;At Label + nL] 

Label is the MACRO label closest to the difference 
and nL represents the decimal number of lines away 
from the label that the difference occurs. If the 
difference occurs at the label, nL is not listed. 
The message for PDP-11 files is: 

[;At Label + nL + following label name] 

Label is the local label name in the form nn$, nL 
represents the decimal number of lines from the 
local label where the difference occurs, and 
following label name is the name of the block 
label. The block label name is listed as further 
help in locating the difference, since local label 
names are not always unique. If the difference 
occurs at the label, nL + following label name are 
not listed. The label name for all labels must be 
in the first ten characters of the line. Label 
name refers to file 1. 

/Q Prints the message ?FILES ARE DIFFERENT, when the 

files are different, but does not list the 
differences. 

/S Ignores spaces and tabs. 

/T Instructs FILCOM to generate output even if no 

differences are found. Ordinarily, FILCOM does 
not produce a list of differences if there are no 
differences in the files. 

/U Compares in update mode. This means that the 

output file consists of the second input file with 
vertical bars (or backslashes for 64-character 
printers) next to the lines that differ from the 
first input file. Any lines found in the first 
input file but not in the second are designated by 
a bullet (o) . This feature is useful when 
updating a document because the changes made to 
the latest edition are flagged with change bars in 
the left margin. The latest edition of the 
document is the second input file. 
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FILCOM Output 

In most cases, headers consisting of the device, file name, extension, 
and creation date of each input file are listed before the differences 
are listed. However, headers do not appear on output from the /U 
switch (update mode on source compare) . 

Output from a source compare has the following notation in the left 
column of the output after the headers: 

n) m 

n is the number of the input file, and m is the page number of the 
input file (refer to the examples) . 

The right column lists the differences occurring between matches in 
the input files. Following the list of differences, a line identical 
in each file is listed for reference purposes. 

The output from the /U switch differs from the above-described output 
in that the output file created is the second input file with vertical 
bars in the left column next to the lines that are different from the 
first input file. 

The output from a binary compare prints the following line on the 
output device when FILCOM encounters a difference between the two 
input files: 

octal loc 1st file-word 2nd file-word XOR of both words 

If the exclusive OR (XOR) of the two words differs only in the right 
half, the third word listed is the absolute value of the difference of 
the two right halves. This usually indicates an address that changed. 

If one input file is shorter than the other, after the end of file is 
encountered on the shorter file, the remainder of the longer file is 
listed . 

Characteristics 
The FILCOM program: 

Places your terminal at user level. 

Destroys your core image. 

Requires LOGIN. 
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Examples 

1. You have the following two ASCII files on disk 

.TYPE FILE1.TST<RET> 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 



P 

Q 
R 
S 
T 
U 
V 
W 
X 
Y 
Z 



.TYPE FILE2.TST<RET> 

A 

B 

C 

G 

H 

I 

1 

2 

3 

N 



P 

Q 
R 
S 
T 
U 
V 
4 
5 
W 
X 
Y 
Z 
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To compare the two files and print the differences on your 
terminal, use the following sequence. 

Run the FILCOM program. 

•R FILCOM<RET> 

Compare the two files on disk and output the differences on 
your terminal. By default, three consecutive identical lines 
determine a match. 

*=FILE1.TST,FILE2.TST<RET> 

FILE 1) DSKC:FILE1.TST[27,5434] CREATED: 0825 dd-mmm-yyyy 
FILE 2) DSKC:FILE2.TST[27,5434] CREATED: 0826 dd-mmm-yyyy 



1)1 


D 


1 


E 


1) 


F 


1) 


G 


**** 




2)1 


G 


************** 


1)1 


J 


1) 


K 


1) 


L 


1) 


M 


1) 


N 


**** 




2)1 


1 


2) 


2 


2) 


3 


2) 


N 


************** 


1)1 


W 


**** 





2)1 4 
2) 5 
2) W 
************** 

%FILES ARE DIFFERENT 
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2. To compare the two files and print the differences on the 
line printer, use the following command. In this example the 
number of successive lines that determines a match has been 
set to four with the /4L switch. 

*/4L = FILE1.TST,FILE2.TST<RET> 

FILE 1) DSKC:FILE1.TST[27,5434] CREATED 0825 dd-mmm-yyyy 

FILE 2) DSKC:FILE2.TST[27,5434] CREATED 0826 dd-mmm-yyyy 



1)1 


D 


1) 


E 


1) 


F 


1) 


G 


1) 


H 


1) 


I 


1) 


J 


1) 


K 


1) 


L 


1) 


M 


1) 


N 


**** 




2)1 


G 


2) 


H 


2) 


I 


2) 


1 


2) 


2 


2) 


3 


2) 


N 


************** 


1)1 


W 


* *** 




2)1 


4 


2) 


5 


2) 


W 


************** 



%FILES ARE DIFFERENT 
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3. To compare the two files so that the second input file is 

output with vertical bars in the left column next to the 

lines that differ from the first input file, use the 
following command sequence: 

.R FILCOM<RET> 

*/U=FILEl.TST,FILE2.TST<RET> 

A 

B 

C 
I G 

H 

I 
I 1 

I 2 

I 3 

N 



P 

Q 

R 

S 

T 

U 

V 
I 4 
I 5 

W 

X 

Y 

Z 

%FILES ARE DIFFERENT 

File number two is displayed. The lines with vertical bars 
indicate the differences between the two files. 
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LISTING GLOBAL SYMBOLS USING GLOB 



Function 

The GLOB program reads multiple binary files and produces an 
alphabetical cross-referenced list of all the global symbols (symbols 
accessible to other programs) that it encounters. This program also 
searches files in library search mode, checking for global symbols, if 
the program file was loaded by LINK in library search mode. (See the 
LINK manual.) 

The GLOB program has two phases of operation: 

1. Phase one scans the input files and builds an internal symbol 
table. 

2. Phase two produces output based on the symbol table. 

Because of these phases, you can enter commands to GLOB in one of two 
ways. The first way is to specify one command string containing both 
the output and input specifications. (This is the command string 
format most system programs accept.) The second is to separate the 
command string into a series of input commands and output commands. 

Formats 

R GLOB 

*output f ile-spec=input file-spec (/switch, /switch) <ESC> 

where; * is the GLOB prompt, and /switch is one or more of the 
switches listed below. 

R GLOB 

followed by one or more input commands in the form: 

file-spec, f ile-speg , . . ,<RET> 
and then one or more output commands in the form: 
output f ile-spec=<ESC> 
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When you separate your input to GLOB into input commands and output 
commands, the input commands contain only input specifications. The 
output commands contain only output specifications. Each output 
command causes a listing to be generated; any number of listings can 
be printed from the symbol table generated from the current input 
files, as long as no input commands occur after the first output 
command. When GLOB encounters an input command after output has been 
generated, it destroys the current symbol table and begins a new- one. 

An ESCape (or ALTmode) terminates the command input and signals GLOB 
to print the cross-referenced listing. A listing is not printed until 
GLOB encounters an ESCape. Press ESCape at the end of the command 
string shown in command format 1 or at the end of each output command 
shown in command format 2. 

If you omit some of the information in a GLOB command, the program 
takes the following defaults: 

o If the device is omitted, it is assumed to be DSK: . However, 
if the entire output specification is omitted, the output 
device is TTY:. 

o If the output file name is omitted, it is the name of the 
last input file on the line (Command Format 1) or is GLOB if 
the line contains only output commands (Command Format 2) . 
The input file names are required. 

o If the output extension is omitted, .GLB is used. If the 
input extension is omitted, it is assumed to be .REL, unless 
the null extension is explicitly specified by a dot following 
the file name. 

o If the directory area [directory] is omitted, your default 
directory is used. 

Switches to GLOB control the type of global listings to be printed. 
If you issue several switches, enclose them in parentheses. Only the 
most recently specified switch (except for L, M, P, Q, and X, which 
are always in effect) is in effect at any given time. If you do not 
specify any switches, GLOB prints all global symbols. The switches 
and their functions are: 

/A Prints all global symbols. This is the default if no 
switches are specified. 

/E Prints only erroneous (multiply defined or undefined) 
symbols. 

/F Prints nonrelocatable (fixed) symbols only. 

/H Prints a list of the switches available from 
HLP:GLOB.HLP. 

/L Scans programs only if they contain globals previously 
defined and not yet satisfied (library search mode) . 

/M Turns off scanning mode resulting from the /L switch. 

/N Prints only symbols that are never referenced. 

/P Prints all routines that define a symbol to have the 
same value. The routine that defines the symbol first 
is printed, followed by a plus (+) sign. Subsequent 
routines that define the symbol are printed, preceded 
by a plus sign. 
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/Q Suppresses the printing of subsequent defining 
routines, which result from the /P switch. 

/R Prints only relocatable symbols. 

/S Prints symbols with nonconflicting values that are 
defined in more than one program. 

/X Suppresses the header page when the output device is 
not your terminal, and includes the header when it is 
your terminal. Without this switch, the header is 
printed on all devices except your terminal. 

Output from GLOB 

The listing header is in the format: 

Flags Symbol Octal Value Defined Referenced 
The flags are: 

Flags Meaning 

M Multiply-defined symbol (shows all values) . 

N Never referred to (was not declared external in any of 
the binary programs) . 

S Multiply specified symbol (that is, defined in more 

than one program but with nonconflicting values) . The 

name of the first program in which the symbol was 
encountered is followed by a plus sign. 

U Undefined symbol. 

Symbols are listed in alphabetical order according to their ASCII 
collating sequence. An apostrophe (') follows the octal value of a 
relocatable symbol. The value is then relative to the beginning of 
the program in which the symbol is defined. 

Characteristics 

The GLOB program: 

Requires LOGIN. 

Places your terminal at user level. 

Destroys your core image. 
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Example 

Run the GLOB program, and print all global symbols in the program MAIN 
(on DSK:), and SUB40 and SUB50 (on DTA2:) on the line printer. Each 
symbol is printed with its value, the program in which it is defined, 
all programs in which it is referenced, and any error flags. 

.R GLOB<RET> 

*LPT:=MAIN.REL,DTA2:SUB40,SUB50<ESC> 

The programs to be scanned are BATCH. REL and DATA.REL on DTA4, 
NUMBER. REL and CLASS. REL on DTA6 : , and MATH. REL and LIBRAR.REL on 
DSK:. 

*DTA4: BATCH. REL, DATA. REL, DTA6: NUMBER. REL, CLASS. REL<RET> 
*DSK : MATH. REL, LIBRAR.REL<RET> 

Print only nonrelocatable symbols on the line printer. 

*LPT:=/F4<ESC> 

Print only relocatable symbols in the file named SYMBOL in your 
default directory. 

*DSK:SYMBOL=/R<ESC> 

Print all erroneous symbols on the terminal. EXTSYM is an undefined 
symbol appearing in the program SUBRTE. 

*TTY:=/E<ESC> 

U EXTSYM SUBRTE 

Return to monitor level. 

*~C 
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Function 

The Network File Transfer (NFT) utility allows you to access files 
residing on DECnet hosts that provide network file access 
capabilities. By using NFT, you can perform a variety of operations 
such as copying, deleting, renaming, or listing files; listing 
directories; and submitting files to a batch system. NFT allows you 
to perform operations at the local host as well as at a remote host. 
You may also use NFT to copy a file from one remote host to another. 

NFT processes text files, programs, data files, control files, or any 
other sequential file. However, only ASCII file transfers are 
supported between a TOPS-10 host and a non-TOPS-10 host. 



Format 



R NFT 

* command output-file-spec = input-file-spec/switches 

where: command is one of the NFT commands described below, file-spec 
is one or more standard file specifications. Depending on the 
command, either the output-file-spec or both file-specs may be 
omitted. /switch is one or more of the switches described 
below. 



/ASCII 



/[NO] BAUD 



/BINARY 



/[NO] MOAN 



Transfers in ASCII mode. Use the /ASCII 
switch for all ASCII file transfers to or 
from a non-TOPS-10 host. 

Does [not] print the baud rate of data 
transfer in the totals summary. This switch 
applies to the COPY and TYPE commands only. 
The default for network transfers is /BAUD, 
/NOBAUD is the default for local transfers. 

Transfers in binary mode. Use the /BINARY 
switch for all file transfers between TOPS-10 
hosts. 

Does [not] issue general warning complaints. 
Use the /MOAN switch to instruct NFT to issue 
warnings when it encounters a dubious 
condition. Such a condition typically 
requires NFT to make a guess (for example, in 
a file copy operation, the data type or data 
byte size) in order to complete the command. 
The default is /NOMOAN. 
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/[NO]OKERROR 



/TOTALS [: list] 



Use the / [NO] OKERROR switch to control 
whether NFT aborts the command if an error 
occurs. /OKERROR directs NFT to ignore file 
access and I/O errors, issuing warning 
messages. /NOOKERROR instructs NFT to abort 
the current command on the first occurrence 
of a file access or I/O error. The default 
setting is /NOOKERROR. 

Use the /TOTALS switch to control the totals 
summary displayed at the end of the command 
execution. The various TOTALS quantities 
(files, errors, baud rate, and so on) can be 
individually controlled by specifying the 
:list argument. If a quantity-name is 
preceded with a NO, that quantity will not be 
listed. If more than one quantity is 
specified, separate them with commas, and 
enclose the list with parentheses. /TOTALS 
or /TOTALS:ALL directs NFT to print a totals 
summary of all applicable quantities at the 
completion (successful or otherwise) of the 
current command. /TOTALS:NONE instructs NFT 
to omit the summary. The /TOTALS quantities 
are : 



o BITS - List the total number of data 
bits. 

o BYTES - List the total number of data 
bytes. 

o WORDS - List the total number of 36-bit 
words. 

o RECORDS - List the total number of 
records. 

o BLOCKS - List the total number of 
128-word blocks. 

o PAGES - List the total number of 512-word 
pages. 

o FILES - List the total number of files. 

o BAUD - List the effective data transfer 
rate (bits per second) • 

o ERRORS - List the total number of 
execution errors. 



The default quantities are WORDS, BLOCKS, 
FILES, and BAUD. NFT ignores inappropriate 
arguments. 
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/USERID:id Use this switch to specify the access 
information (userid, account, and password) 
when using NFT for a non-TOPS-10 host. You 
include the /USERID switch with the file 
specification of the remote file. If you 
omit an argument from the switch, NFT prompts 
you for that argument. If the remote host 
does not require the information, you can 
press the <RET> key. The form of the /USERID 
switch is: 

/USERID :uid: ace t :psw 

where uid is user-name, acct is an account 
string, and psw is a password. If you omit 
the account or password argument, you must 
still include its preceding colon (:). For 
example, if you omit the password: 

/USERID:smith:1776: 

NFT prompts you for it. You then supply a 
password, which NFT does not echo. 

NFT automatically prompts you for access 
information if you include /USERID without 
arguments in the form: 

NFT /USERID 

You can include this command and switch in 
your SWITCH.INI file. If you include 
arguments with the /USERID switch in 
SWITCH.INI, you are specifying a particular 
userid. You can override this switch setting 
by including an explicit /USERID:uid switch 
on a command line to NFT. You can also use 
the SET DEFAULT command to specify access 
information for one or all remote nodes. 
Defaults set this way apply for the duration 
of the current NFT session. 

For a TOPS-10 remote file, you can omit the 

PPN if the userid and the project-programmer 

number are identical. For example, you can 
enter : 

♦DIRECT IRIS: ; [27, 777] /USERID: 27, 777 : :FQO 

as: 

♦DIRECT IRIS: ?/USERID:27,777: :F00 
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The NFT commands are: 

Command 

COPY [output file-spec=] 
input file-spec 



DELETE file-spec (s) 

DIRECT [output file-spec=] 
input file-spec 

EXIT 

HELP 

PRINT file-spec 



RENAME output file-spec (s) = 
input file-spec 



SET DEFAULT [node::=] 

/USERID[:uid[:acct[:psw]] ] 



SUBMIT file-spec 



Action 

Copies files from: 
local node to remote node 
local node to local node 
remote node to local node 
remote node to remote node 



Deletes files from 
remote node. 



local 



or 



TYPE [output file-spec=] 
input file-spec 



Lists the directory from the 
specified node. 

Exits from NFT. 

Displays a list of NFT commands. 

Prints a file at the specified 
node. NFT does not check that the 
file is actually printed at a 
remote node. The file must be 
located at the node in an 
acceptable format; and print 
spooling must be available at the 
node. 



Changes the name or attributes of a 
file. Valid only for nodes that 
support remote renaming. 



Sets the defaults for the access 
information for one or more remote 
nodes. The defaults remain in 
effect until you change them using 
another SET DEFAULT command or exit 
from NFT. NFT applies the defaults 
in SWITCH.INI after it sets the 
defaults from the SET DEFAULT 
command. 

Submits a batch control file or a 
command file on a local or remote 
node. NFT does not check that the 
file is actually submitted. The 
control/command file must be at the 
node in an acceptable format; and 
the batch or command file facility 
must be supported and available at 
the node. 

Displays the specified file on your 
terminal . 
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In addition to the standard commands, commands called DAP-mode 
commands are available. They are the DDELET (delete), DDIREC 
(direct) , DRENAM (rename) , and DSUBMI (submit) commands. You can use 
these commands to quickly manipulate a single file on a single host, 
or if the remote host does not appear to accept the standard NFT 
command. If you use these commands, you can include only one input 
file specification. These commands may execute faster than the 
standard commands because they do not have the same command scanning 
and checking as the standard commands. In some cases, they may not 
give the same amount or type of information as the standard commands. 

All NFT and DAP-mode commands described above work between TOPS-10 
hosts, and with your files on the local host. However, a command 
works on a non-TOPS-10 host only if that host has also implemented 
that facility. For example, you can copy files between a TOPS-10 host 
and a VMS host because both hosts have implemented the COPY facility. 

For those commands with input and/or output file specifications, the 
defaults for the command string are listed below. Though most of the 
defaults are the same for all the commands, some commands have 
different defaults. The exceptions are noted with each field's 
default. 

Field Default 

node local node 

all remote nodes for SET DEFAULT 
unchanged for RENAME output 

device DSK: for local node, none for remote node 
TTY: for DIRECT and TYPE output 
unchanged for RENAME output 

directory no explicit directory 

unchanged for RENAME output 

file name output - input file name 

- generated name for DIRECT 

- unchanged for RENAME 
input - * 

- must be specified for DELETE 

file type output - input file type 

- DIR for DIRECT 

- unchanged for RENAME 
input - * 

- must be specified for DELETE 

- CTL for SUBMIT 

- none for PRINT 

I/O mode file creation mode, assumed to be ASCII 
ASCII for DIRECT and TYPE 

Characteristics 
The NFT program: 

Requires LOGIN. 

Destroys your core image. 

Leaves your terminal at user level. 



6-5 



NETWORK FILE TRANSFER USING NFT 



Examples 



1. Copy a file from the local node to a remote VMS host. 
Override the /USERID specified in your SWITCH.INI file. 

.R NFT 

*COPY ROSE: :/USER=PLANNI 

For remote ROSE::*.* 

User-id: BARSTOW 

Account: 

Password : 

ROSE: COMMUNITY: [BARSTOW] PLANNI .. 2 <= 
DSKC: [52,654] PLANNI 
Total of 398 words in 4 blocks in 1 file at 20395 baud 

2. Copy a file from a TOPS-20 host to a RSTS host while logged 
in on a TOPS-10 host. You must specify a /USERID switch for 
each remote host. 

.R NFT 

*COPY LILY: :/USER=DAISY: : PLANNING-GUIDE/USER 

For remote DAISY: :PLANNING-GUIDE.* 

User-id: THRING 

Account: 

Password : 
For remote LILY::*.* 

User-id: 15,177 

Account: 

Password : 

LILY: :SY: [15, 177] PLANNI <= 
DAISY: :PS: [THRING] PLANNING-GUIDE. . 5 
Total of 483 words in 4 blocks in 1 file at 5851 baud 

3. Delete all the files with name UUOSYM from a directory on a 
TOPS-20 host. You must include the /USERID switch, but need 
not explicitly specify the directory because it is the same 
as the userid. 

• R NFT 

*DELETE DAISY: : UUOSYM. */USER 

For remote DAISY: : UUOSYM.* 

User-id: THRING 

Account : 

Password : 
DAISY: :PS: [THRING] UUOSYM. REL. 1 

DAISY: :PS: [THRING] UUOSYM. UNV. 1 
Total of 33 blocks in 2 files 
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Access a directory not your own on a remote TOPS-10 host 
called IRIS. Since your account on the system allows you 
read access to the directory, you can specify the other 
directory and your userid and read the directory. 

.R NFT 

*DIRECT IRIS: : [17 , 353] /USER 

For remote IRIS : : [17 ,353] * .* 

User-id: 27,777 

Account: 

Password : 



IRIS 
IRIS 
IRIS 
IRIS 
IRIS 
IRIS 
IRIS 



DSKA: [1,2]DSKA.BAK 
DSKA: [1,2]DSKA1.FUL 
DSKA: [1,2]INC.BAK 
DSKA: [1,2]FUL.BAK 
DSKA: [1,2] DSKA. INC 
DSKA: [1,2]INC.MIC 
DSKA: [1,2]FUL.MIC 



Total of 7 files 

To access accounts with different access information on 
several remote nodes, set the default access information for 
all of them. 



.R NFT 

*SET DEFAULT ROSE: 

*SET DEFAULT IRIS: 

*SET DEFAULT LILY: 

*SET DEFAULT DAISY 

*COPY ROSE: :=DAISY 

For remote DAISY: :FCC.ASC#* 

User-id :thing 

Account: 

Password : 



=/USER : BARSTOW : HAHA : HOHUM 
=/USER: 27,777 :WRITER:FOFUM 
=/USER: 15, 177: SCHOLAR: FEEFI 
:=/USER 
:FCC,ASC 



Submit a command file to the VMS command file processor on 

host ROSE:. You have included a /USERID switch for that host 

in your SWITCH.INI file so you do not have to include that 
switch in the command string. 

.R NFT 

*SUBMIT ROSE: :ABVAX.CTL 

ROSE: COMMUNITY: [BARSTOW] ABVAX. CTL. 1 
Total of 1 file 
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Function 



The OPSER program allows you to control up to 14 subjobs from your 
terminal. OPSER acts as the supervisor of the subjobs by passing 
monitor-level or user-level commands to all or to selected subjobs. 
OPSER can retrieve output from the various subjobs. 

OPSER subjobs run on pseudo-terminals (PTYs) . It performs all 
pseudo-terminal initialization. You provide the subjob name and 
either an OPSER-provided subjob number or a user-assigned name. 
System programs or your programs that require a dedicated terminal can 
be run as subjobs of OPSER. By running jobs on PTYs, OPSER maintains 
an I/O link between you and the running jobs. 

Format 

R OPSER 
* scommand 

where: An asterisk (*) is the OPSER prompt if no subjobs are in use 
or if subjobs are waiting for commands. OPSER responds with 
an exclamation point when a subjob is running. You can enter 
commands whenever OPSER is operating. Each command must be 
preceded by a colon and may be abbreviated to a unique set of 
characters. 

Commands to OPSER and their functions are: 



Command 

:AUTO/hh:mm 
filename 



:AUTO/+hh:mm 
filename 



:AUTO/>hh:mm 
filename 



Function 

Processes the named file as a list of 
interactive commands. The AUTO file is 
terminated by either an end-of-file or 
the operator typing a line on the 
console. AUTO files may call other 
files, including themselves. The 
optional /hh:mm switch sets the time to 
run the auto file. If this time has 
passed, the AUTO file runs immediately. 

Processes the AUTO file after the amount 
of time specified by the +hh:mm has 
elapsed . 

Processes the AUTO file at the next 
occurrence of hh:mm. 
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Command 

:AUTO/<hh:mm 
filename 

~B 

~C 



:CLOSE 



rCONTINUE 



: CURRENT 



: DAYTIME 
:DEFINE xxx=n 

:DEVICE devtlog :n 



: ERROR n,m,p 



:EXIT 



:FREE 
:HELP 

:JCONT n 

:KILL n,m,p 



Function 

Does not process the AUTO file if time 
has already gone past hh:mm. 

Sends "0 (CTRL/0) to the subjob. 

Returns you to monitor level even if you 
have active subjobs running. Use the 
:EXIT command (described below) in most 
cases . 

Closes the log file without opening a 
new one. 

Continues processing the AUTO file after 
it has been interrupted by a CTRL/C. 
This allows you to gain control of a 
subjob during AUTO file processing. 

Displays the name of the current subjob, 
if defined; otherwise, displays the 
number of the current subjob. Output 
from another subjob does not affect the 
definition of the current subjob. 

Displays the current date and time. 

Associates the symbol xxx as the name 
for subjob n. The symbol B is reserved 
for the subjob running BATCON. 

Assigns the device (dev:), and logical 
name (log) to subjob n. The logical 
name is optional, but you must include a 
null field if the logical name is 
omitted, for example, :DEVICE CDR::3. 
The REENTER command aborts the request. 

Displays only error messages. (That is, 
ignores nonerror messages from subjob 
n.) Printing resumes with the : REVIVE 
command. 

Exits to the monitor if subjobs are not 
in use; otherwise, give a list of those 
that are running. This should be used 
instead of CTRL/C, because :EXIT does 
not return your job to monitor level if 
there are any active subjobs. (Also 
refer to :M0NIT0R.) 

Displays the first free subjob number. 

Displays text that briefly explains 
OPSER commands. 

Continues the specified currently halted 
job. 

Logs out the specified subjobs. This is 
identical to :KJ0B. 
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Command 



:KJOB n,m,p 



: LOGIN proj ,prog 



: MONITOR 



:MSGLVL n 



:QUEUE <line> 



:RESOURCES 



: REVIVE n 



:SCHED 



SEND 

: SILENCE n 
SLOGIN proj ,prog 



Function 

Logs out the specified subjobs, saving 
all files. 

Logs in a new subjob. If you do not 
type a project-programmer number, OPSER 
assumes your project-programmer number. 

Exits to the monitor, even if subjobs 
are running. 

Determines whether the response to the 
:WHAT command includes the JOBSTS bits. 
If n=0, the bits are included. If n=l, 
they are eliminated. If you do not 
specify n, the JOBSTS bits are not 
included . 

Initiates the first free subjob and 
sends the typed-in line to the system 
queue manager. 



Displays the list of the 
system resources. 



available 



Resumes normal echoing of output from 
subjob n (that is, clears the effects of 
rSILENCE, :TSILENCE, and :ERROR for 
subjob n) . 

Displays the schedule bits as set by the 
operator. 



Bit Meaning 

Regular timesharing. 

No further LOGINS except from CTY. 



No further LOGINS from remote 
terminals, and no answering of data 
sets . 

Batch jobs only. 

Device MOUNTS can be done without 
operator intervention. 



200 Unspooling allowed. 

400 No operator coverage. 

1000 No automatic down-line loading of 
nodes. 

Simulates the SEND command, sending a 
line of text to the operator's terminal. 

Suppresses all output from subjob n. 

Logs one subjob in but suppresses its 

response. If you omit the 

project-programmer number, OPSER uses 
yours. 
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Command 



Function 



STOP n 



SYSTAT x 



:TIME 



TLOG file-spec 



:TSILENCE n 



;TTYTST 



:WHAT n,m,p 



:WHERE devn 



When a subjob number or 
(indicated by n, m, p) , 
following ways: 



Puts the specified subjob at monitor 
level. This is equivalent to typing two 
CTRL/Cs in interactive mode. 

Runs SYSTAT with argument x over the 
first free subjob. The argument can be 
any valid SYSTAT argument. (Refer to 
the TOPS-10 Operating System Commands 
Manual .) The argument is optional . 

Displays the total running time since 
the last :TIME command, followed by the 
integrated product of running time and 
core size. 

Creates a log file with the specified 
name. If the file already exists, a 
message is printed to determine whether 
the existing file should be superseded. 
If not, OPSER appends the file to the 
existing one. Default for file-spec is 
0PSER.LOG on DSK:. 

Suppresses all output from subjob n 
(same as the : SILENCE command) but 
places entries into the log file. 

Tests this terminal by printing all the 
ASCII characters between octal 40 and 
174, inclusive. 

Prints the status of the specified 
subjobs on the terminal. The status 
includes a SYSTAT with the time, the 
time of the last input and the last 
output, a listing of the JOBSTS bits 
depending upon the value of :MSGLVL, and 
the time of the next timed AUTO file. 

Prints the node number of the device's 
physical location. 

name is required in a command string 
you can specify the subjob in any of the 



o Omit it, in which case the last subjob typed into is used. 

o Specify ALL, in which case all active subjobs are implied. 

o Specify a decimal number, or a list of numbers separated by 
commas, from to the OPSER limit, which designates that 
particular subjob number. 

o Specify a name, or a list of names separated by commas, 
previously assigned to a particular subjob with the : DEFINE 
command . 
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Characteristics 
The OPSER program: 

Requires LOGIN. 

Destroys your core image. 

Places your terminal at user level. 

Example 

The following is an example of an automatic startup file. 

.TYPE SYS:TTY4.AT0<RET> 

:TLOG DSKNtOPSER4.LOG 

:SLOG 

:DEF Ll= 

:SLOG 

:DEF L0= 

:SLOG 

:DEF M= 

:SLOG 

:DEF B= 

:TSILEN ALL 

Ll-AS LPT1 

Ll-R LPTSPL 

Ll-FREEZ 

Ll-MLIMIT 5000 
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Function 

The PIP program transfers files between standard I/O devices at the 
local system. It can perform simple editing and magnetic tape control 
operations during transfer operations. 

Format 

R PIP 

* output file-spec (s) /switches = input file-spec (s)/switches 

where: * is the PIP prompt; output file-spec and input file-spec are 
file specifications which may include wildcards; and = (equals 
sign) separates the output from the input files. You must 
include this, even if you omit either file specification, 
/switch is one or more of the options described below. Each 
description includes any restrictions on combining that switch 
with other switches. 

Switch Meaning 

/A Does not split lines between output buffers; 

starts each line with a new word. Used for 
FORTRAN ASCII input. This switch may be used with 
/C, /E, /G, /M, /N, /0, /Q, /S, /V, and /Z. 

/B Copies in binary mode. This switch is legal with 

/G, /M, /P, /Q, and /X. 

/C Deletes trailing spaces and converts multiple 

spaces to tabs. You can use this switch with /A, 

/E, /G r /J, /M, /N, /0, /Q, /S, /T, /V, /W, /X, 
and /Z. 

/D Deletes one or more files from the destination 

device. You can only specify a destination device 
in the command string. You may use the /X switch 
with /D. 

/E For card reader input, ignores card sequence 

numbers. In other words, this switch replaces 
characters in columns 73-80 with spaces. This 
switch can be used with the /A, /C, /G, /J, /M, 
/N, /0, /Q, /S, /X, and /Z switches. 

/F Gives a limited (fast) version of the directory 

for the specified device. You may not use any 
other switches with this one. 
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Switch Meaning 

/G Ignores I/O errors and continue processing after 

issuing an error message. This switch is always 
legal . 

/H Copies in image binary mode. You can use /H with 

/G, /M, /X, and /Z. 

/I Copies in image mode. You can use this switch 

with /G, /M, /X, and /Z. 

/J Converts non-printing control characters to 

control-character format for terminal output. 
That is, 001, <CTRL/A>, is output as "A. /A, /C, 
/E, /M, /W, and /X are permitted with this switch. 

/L Lists the directory for the specified device. You 

may only use /Z with this switch. 

(Mx) Magnetic tape switches, enclosed in parentheses. 
They are listed below. You may not use /D, /F, or 
/U with this switch. 

Switch Meaning 

(M8) 800 bpi density (default value) 

(M5) 556 bpi density 

(M2) 200 bpi density 

(ME) Even parity (odd parity is default) 

(M#nA) Advance tape reel n files. #n 

omitted means one file. 
(M#nB) Backspace tape reel n files. #n 

omitted means one file. 
(M#nD) Advance tape reel n records. #n 

omitted means one record. 
(M#nP) Backspace tape reel n records. #n 

omitted means one record. 
(MW) Rewind tape reel. 

(MT) Skip to logical end-of-tape. 

(MU) Rewind and unload. 

(MF) Mark end-of-file. 

/N Deletes line sequence numbers from an ASCII file. 

If tab follows the sequence number, deletes the 
tab also. You may use /A, /C, /E, /G, /M, /Q, /X, 
and /Z with this switch. 

/0 Resequences or adds line sequence numbers to an 

ASCII file, incrementing by 1. You may use /A, 
/C, /E, /G, /M, /X, and /Z with this switch. 

/P Converts FORTRAN format control characters for 

line printer listing. You may use /B and /Z with 
this switch. 

/Q Lists a summary of switches on the specified 

device. You may not use /Q with /D, /F, /R, and 
/V. 

/R Renames the source file to the name of the 

destination file. /X may be used with /R. 
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Switch Meaning 

/S Resequences or adds line sequence numbers to an 

ASCII file, incrementing by 10. /A, /C, /T, and 
/Z are all valid with /S. 

/T Deletes trailing spaces from the transferred file. 

Keeps one space and the line termintor for an 
all-space line. You may use /C, /S, and /Z with 
this switch. 

/U Obsolete. 

/V Matches angle brackets. If there is an unmatched 

angle bracket, creates a file listing those lines 
with unmatched angle brackets. You may use /G, 
/M, and /Z with /V. 

/W Converts tabs to spaces. /C and /Z are legal with 

this switch. 

/X and /DX Copies the specified files without concatenating 
the files. /DX copies all but the specified 
files. If you omit the /X switch, PIP 
concatenates the files while copying. You may not 
use /F or /L with this switch. 

/Y Obsolete. 

/Z Zeroes the directory of the destination device. 

PIP attempts to delete all the files named in the 
directory, depending on the protection codes. You 
may not use this switch with /D or /R. 

PIP can transfer files in either ASCII or binary mode. PIP uses the 
file extension in the file specification to determine which mode to 
use. Whenever possible, PIP transfers files in a binary mode since it 
is faster. The binary modes are: binary, image, and image binary. 

PIP performs a specific series of tests on a file extension in order 
to determine the mode to use during a transfer operation. PIP looks 
for: 

o The presence of a data mode switch. If no switch is found, 
PIP goes to the next test. 

o The presence of a known (standard) file extension that 
specifies a binary mode of transfer. If no binary extensions 
are found, PIP goes to the next test. 

o The input and the output devices specified, to determine if 
they are capable of handling binary data. If either of the 
devices cannot handle binary, the transfer is made in ASCII 
mode. If both devices can handle binary data, PIP goes to 
the next test. 

o The presence of the /X switch in the command string; if it is 
found, the transfer is made in binary mode. If an X option 
is not found, PIP goes to the next test. 

o The presence of commas (non-delimiters) in the command 
string; if commas are found, ASCII mode is indicated. If no 
commas are found, the transfer is made in binary mode. 
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Characteristics 
The PIP program: 

Requires LOGIN. 

Destroys your core image. 

Places your terminal at user level 

Examples 

1. Run PIP, and list your directory on your terminal. 

.R PIP 
*TTY:/L= 

2. Transfer files from area [11,7] to your directory without 
concatenation. 

*DSK:/X=DSK: [11,7] f ilea.rel ,f ilea. mac 

3. Combine all the files on the tape on MTA0 : into one file in 
your directory. 

*DSK : TAPE . MAC=MTA0 : * 

4. Rename the file MONI.MAC to MONI.CBL 

*DSK:MONI.CBL/R=MONI.MAC 

5. Change the directory access code of [57,123] to <222>. 

*DSKA: [57,123] .UFD<222>/R=[57, 123] .UFD 

6. Transfer a file from MTA1: to MTA2: at 200 bpi with even 
parity. 

*MTA2: (M2E)=MTA1: (ME2) 

7. Backspace MTA0: to the start of the previous file. (MB) is 
equivalent to (M#1B) . 

*MTA0: (MB)= 

8. Backspace MTA2: to the start of the current file. 

*MTA2:(M#0B)= 
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Function 

The QUOLST program prints the amount of disk space used and the amount 
left on each file structure in your search list. In addition, it 
prints the amount of space the file structures have left for all 
users. The information printed on your terminal is: 

o The structure name. 

o The number of blocks allocated. 

o The number of blocks left in the logged-in quota, in the 
logged-out quota, and on the structure. 

Format 

R QUOLST 

Characteristics 

The QUOLST program: 

Destroys your core image. 

Leaves your terminal at monitor level. 

Example 

.R QUOLST<RET> 

USER: 27,5434 

STR USED LEFT: (IN) (OUT) (SYS) 

DSKC: 1355 8645 3645 61995 

DSKB: 10000 5000 96870 
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Function 

The RUNOFF program formats text files using commands you insert into a 
file. You create the file and insert the RUNOFF commands using one of 
the standard TOPS-10 text editors. 



Format 

R RUNOFF 
*f ile-spec 

where: * is the RUNOFF prompt; file-spec is a file specification with 
standard defaults and wildcard features. The normal extension 
for a file that RUNOFF processes is .RNO. The processed file 
has an extension of .MEM. You can queue this file to a line 
printer, or display it on your terminal. 

The commands listed below are inserted into the text file to cause 
RUNOFF to perform some action. All RUNOFF commands begin with a 
period (.). You can abbreviate all commands. 

Some commands require either numeric or text arguments. In either 
instance, you type the command, one space, and then the argument. 
When you have several commands to input, you can list all of them on 
one line, separating them with periods. However, if the first command 
has a comment or takes text as its argument, you must use a semicolon 
to separate the commands. Comments must be preceded by an exclamation 
point ( ! ) . 



Command 

.APPENDIX "text" 
.AUTOPARAGRAPH 
.AUTOTABLE 

.BEGIN BAR 

.BLANK n 
.BREAK 
•CENTER n 
•CHAPTER "text" 



Function 

Starts appendix with "text" as its name. 

Treats leading spaces as new paragraph. 

Treats lines without leading spaces as 
new paragraph. 



Starts a change bar, which 
the left hand margin. 



appears in 



Skips n lines. 

Starts a new output line. 

Centers the next line around column n/2. 

Starts chapter with text as name. 
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Command 

.COMMENT 

.CONTROL CHARACTERS 

.DISABLE BAR 

.DO INDEX "title" 

.ELSE 

.ENABLE BAR 
.ENDIF name 
.END BAR 
.END FOOTNOTE 
•END LIST 
.END LITERAL 
.END NOTE 
.END SELECTION 

.END SUBPAGE 

.FIGURE n 

.FIGURE DEFERRED n 

.FILL 

.FIRST TITLE 
.FLAGS ALL 
.FLAGS type "ch" 

.FOOTNOTE n 
.HEADER x 

.HEADER LEVEL n 

.IF 

.IFNOT name 

.INDENT n 



Function 

Ignores this command. 

Allows control characters to print in 
the text. 

Ignores change bars. 

Outputs index with rest of line as 
title. 

Changes sense of IF/IFNOT. 

Allows change bars. 

Ends conditional input. 

Ends change bar. 

Ends a footnote definition. 

Ends a list. 

Ends a literal block of text. 

Ends a NOTE command. 

Stops selection until single line 
prefix. 

Stops subpage numbering (resumes page) . 

Makes space for n-line figure. 

Same as FIGURE except the figure may be 
on next page. 

Resumes filling and justifying each 
line. 

Includes title on first page. 

Enables existing flag characters. 

Changes flag character of the specified 
type to "ch". 

Starts n-line footnote. 

Issues "page" in case x, where x is 
UPPER, LOWER, or MIXED case. 

Starts section at level n (1-5) ; rest is 
name. 

Starts conditional input if VARIANT 
name. 

Starts conditional input if not VARIANT 
name. 

Indents next line n spaces. 
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Command 
.INDEX 
.JUSTIFY 
.LEFT n 

•LEFT MARGIN n 
.LIST n 
.LIST ELEMENT 
.LITERAL n 

.LOWER CASE 

•NO AUTOPARAGRAPH 

.NO AUTOTABLE 

.NO CONTROL CHARACTERS 

.NO FILL 

.NO FLAGS ALL 

.NO FLAGS type 

.NO HEADER 
.NO JUSTIFY 
•NO NUMBER 
.NO PAGING 
.NO PERIOD 

.NO SELECTION 
.NO SPACE 
.NO SUBTITLE 
.NOTE text 

.NUMBER n 

•NUMBER APPENDIX n 
.NUMBER CHAPTER n 
•NUMBER INDEX 



Function 

Inserts rest of this line in index. 

Resumes justifying text. 

Starts next line n columns from left 
margin. 

Sets left margin. 

Starts list of items with spacing n. 

Starts of item in a list. 

Starts a literal block of text n lines 
long. 

Starts footnotes and text in lower case. 

Stops autoparagraph mode. 

Stops autotable mode. 

Does not allow control characters. 

Stops fill and justify. 

Disables existing flag characters except 
. and ! . 

Does not use flag characters of the 
specified type. 

Suppresses page headers. 

Stops justifying. 

Stops page numbering. 

Stops splitting into pages. 

Stops double spacing after period, 
exclamation point, semicolon, colon, and 
question mark. 

Accepts all text as input. 

Suppresses space on this end of line. 

Suppresses subtitles. 

Starts indented note with heading "text" 
centered. If you omit "text," RUNOFF 
uses the heading NOTE. 

Resumes page numbering at page n. 

Sets appendix number to n. 

Sets chapter number to n. 

Sets chapter number to "INDEX". 
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Command 

.NUMBER LEVEL 

a , d , c , . • « 

.NUMBER LIST d, C 

.NUMBER PAGE n 

.NUMBER SUBPAGE ch 

.PAGE 

•PAGE SIZE n,m 
.PAPER SIZE n,m 

.PAGING 

.PARAGRAPH n, v, t 



.PERIOD 

.PRINT INDEX 
.RIGHT n 

.RIGHT MARGIN n 
.SELECTION string 
.SKIP n 
.SPACING n 
.STANDARD n 
.SUBINDEX 

.SUBPAGE 

.SUBTITLE or .SUBTTL 



Function 

Sets next HEADER LEVEL to a, b, c,... 

Sets list counter depth d to c. 

Resumes page numbering at page n. 

Sets subpage number to ch (A-Z) . 

Starts new page. 

Sets page size to n lines by m columns 
Sets paper size to n lines by m columns. 

Resumes breaking into pages. 

Starts a new paragraph, indented n 
spaces, starting v blank lines below the 
previous paragraph, and having t as the 
TEST PAGE value. 

Double spaces after period, exclamation 
point, semicolon, colon, and question 
mark. 

Starts printing index. 

Right adjusts next line n columns left 
of the margin. 

Sets right margin to n. 

Sets selection string. 

Skips n*spacing lines. 

Sets spacing (default=l) . 

Sets standard setup of width n. 



Indexes with "#" used to 
sub-indices. 

Starts subpage numbering. 

Uses rest of line as subtitle. 



delimit 
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While inputting your text, you have the option of including special 
characters to alter the case and mode operations. You type these 
characters immediately before the word or group of words you want to 
arrange. Just like RUNOFF commands, these special characters do not 
appear in your output after running RUNOFF. Special text characters 
include: 



Flag 
Character 

Underscore (_) 

Circumflex (*) 

Back-slash (\) 

Number sign (#) 

Ampersand (&) 

Less-than (<) 

Greater-than (>) 

Exclamation point (!) 

Period (.) 

Semicolon (;) 



Function 

Takes next character as text. 

Uppercases next character. 

Lowercases next character. 

Treats as an expandable space. 

Underlines next character. 

Capitalizes the following word. 

Indexes the following word. 

Ends footnote or begins comment. 

Treats what follows as a RUNOFF command. 

Used to separate multiple commands. 



Characteristics 
The RUNOFF program: 

Requires LOGIN. 

Destroys your core image. 

Places your terminal at user level. 
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Examples 

1. Use the .LIST and .LIST ELEMENT commands to create a list. 

.NF.LS 

.LE;Page numbers on every page except the first, 

.LE;Spacing 1 between lines, 

,LE;Fill and justify, 

,LE;Tab stops 9,17,25,33,41,49,57,65, 

.LE;Left margin 0, 

.LE;Right margin 60, 

.LE;Page size - Width 60 characters, Length 58 lines. 

.ELS 

Your output would look like the following: 

1. Page numbers on every page except the first, 

2. Spacing 1 between lines, 

3. Fill and justify, 

4. Tab stops 9,17,25,33,41,49,57,65, 

5. Left margin 0, 

6. Right margin 60, 

7. Page size - Width 60 characters, Length 58 lines. 

2. To get header levels in your text, you can insert commands in 
your text as follows: 

.FLAG CAPITALIZE 

.CHAPTER EXAMPLE 5 

.HL 1 FIRST LEVEL OF SECTION 1 

The command XHEADER <LEVEL starts a section at the level 

specified and takes the following text as the header. ##The 

n can be in the range from 1 to 5. 

.HL 1 SECOND LEVEL OF SECTION 1 

The sections are incremented by 1, and the number is 

output in the form i . j .k.l ,m.##If this is a chapter 

oriented document, the i is the chapter number ;#otherwise, the 

i is the number of the ,<HI 1 level. 

.HL 1 THIRD LEVEL OF SECTION 1 

This command acts as 

.SKIP 3;.N0FILL 

.<BREAK .<TEST <PAGE 9; ,<BLANK 3 
.SKIP 3;. FILL 

followed by the section number .##<HEADER <LEVEL<S 1 AND 2 
end with a .<BREAK.##<HEADER <LEVEL<S 3, 4, AND 5 end with 
a space dash space combination ( #- #) . 
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Your output would look like: 



CHAPTER 1 
EXAMPLE 5 



1.1 FIRST LEVEL OF SECTION 1 

The command .HEADER LEVEL starts a section at the level specified and 
takes the following text as the header. The n can be in the range 
from 1 to 5. 



1.2 SECOND LEVEL OF SECTION 1 

The sections are incremented by 1, and the number is output in the 
form i.j.k.l.m. If this is a chapter oriented document, the i is the 
chapter number; otherwise, the i is the number of the .HL 1 level. 



1.3 THIRD LEVEL OF SECTION 1 
This command acts as 

.BREAK .TEST PAGE 9;. BLANK 3 

followed by the section number. HEADER LEVELS 1 and 2 end with a 
.BREAK. HEADER LEVELS 3, 4, and 5 end with a space dash space 
combination (#-#) . 
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SETTING SEARCH LISTS USING SETSRC 



Function 

You can use the SETSRC program to change your job search list or the 
system search list. You must be logged in under [1,2] to create a new 
system search list. A search list is the order of the file structures 
that are to be searched whenever you implicitly or explicitly specify 
the generic device DSK:. The system manager originally defines the 
search list to include the file structures that you can access. With 
the SETSRC program, you can alter the search list by adding or 
deleting file structures. 

The search list is of the form: 

fsl:, fs2:, fs3:, FENCE, fs4: 

where: fs is the name of the file structure. 

The file structures on the left of the FENCE form the active search 
list and represent the generic device DSK: for your job. The active 
search list is a list of the file structures that the monitor 
searches, and the order in which the file structures are to be 
searched. The search goes from left to right. 

The files to the right of the FENCE compose the passive search list 
and represent the file structures that were once in the active search 
list. File structures are kept in the passive search list so that 
quotas can be checked on a DISMOUNT or KJOB command; these structures 
are not searched. The FENCE is the boundary between the active and 
passive search lists. 

You can change the job's search list by adding or deleting file 
structures, using the MOUNT and DISMOUNT commands. Because the SETSRC 
program does not create a UFD if one does not exist, use the MOUNT 
command to create a UFD. Refer to the TOPS-10 Operating System 
Commands Manual for a description of the MOUNT and DISMOUNT commands. 
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Format 



R SETSRC 

* command/switch 

When the program prompt (*) appears, you can respond with any of the 
following commands: 



Command 



A fsl, fs2, . . . 



Function 

Adds one or more file structures to the 
existing active search list. The file 
structures (with any switches) are appended 
to the beginning or the end of the active 
search list according to the following 
specifications: 

o If no asterisk appears in the 
specifications (for example, fsl, fs2) or 
if an asterisk appears before the file 
structure names (for example, *,fsl, 
fs2) , the file structures are added to 
the end of the search list. 



C fsl,fs2,... 

CP[dir] 

CS fsl,fs2,. . . 



M/switch 



R fsl,fs2, . .. 



o If an asterisk follows the file structure 
names (for example, fsl, fs2, *,), the 
file structures are added to the 
beginning of the search list. 

o If the asterisk appears in the middle of 
the file structures (for example, fsl, *, 
fs2) , the file structures before the 
asterisk are added to the beginning of 
the search list and the file structures 
after the asterisk are added to the end. 

Creates a new search list for this job. Any 
file structures in the current search list 
that are not in the new list are moved to the 
passive search list. 

Creates a new default directory path. You 
must specify the new path with this command. 

Creates a new system search list (that is, 
the file structure search list for device 
SYS:). You must be logged in under [1,2] to 
use this command. 

Prints information (HELP) about the available 
commands. 

Modifies the current search list and DSK: 
specification by altering the switch settings 
for individual file structures. This command 
does not add or remove file structures from 
the search list. 

Removes file structures from the search list. 
They are placed into the passive search list, 
so that on subsequent LOGOUTS or DISMOUNTS, 
quota limits can be checked. This command 
does not affect ersatz devices. 
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Command 

T 

TP 

TS 



Function 

Prints the job search list. 
Prints the default directory path, 
Prints the system search list. 



You can use the following switches in the SETSRC command string. 
Switches that modify file structures must appear immediately after the 
file structure name that they modify. Other switches can appear 
anywhere in the command string. The switches can be abbreviated as 
long as the abbreviation is unique. 



Switch 



/CREATE 



/LIB: [proj ,prog] 



/NEW 



/NOCREATE 



/NOLIB 



/NONEW 



/NOSCAN 



/NOSYS 



Function 

Allows new files to be created on the 
file structure. This is the default. 

Used with the C or M command only, /LIB 
sets the job's library directory to the 
UFD [proj, prog] and adds it to your DSK: 
specification. This means that if a 
file is not found in your directories in 
your search list, the library directory 
will then be searched for the file. If 
you only type LIB:[PPN] to SETSRC, it 
interprets this as M/LIB. 

Adds the directory [1,5] to your SYS: 
specification. This means that when the 
system directory is searched, the 
directory [1,5] will be searched before 
the directory [1,4]. This switch can be 
typed in directly as a command by 
omitting the C or M command and the 
slash (NEW is equivalent to M/NEW) . 

Does not allow new files to be created 
on the file structure when you specify 
DSK:, but allows files to be superseded. 
Files can be created on the file 
structure if you specify the file 
structure name explicitly. You may 
specify this switch as /N. 

Removes the library directory from your 
DSK: specification. This switch is 
only valid with the C or M command. 

Removes the [1,5] directory from your 
SYS: specification. This switch is 
only valid with the C or M command. 

Cancels the scan switch for the 
directory path. You can use this switch 
only with the CP command. If you type 
NOSCAN at the prompt, SETSRC interprets 
it as CP[dir] /NOSCAN. 

Removes the SYS: specification from 
your DSK: specification. This switch 
is only valid with the C or M command. 
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Switch 



/NOWRITE 



/SCAN 



/SYS 



/WRITE 



Function 

Does not allow writing on the file 
structure for this job (that is, the 
file structure is read-only) . You may 
specify this switch as /R. 

Sets the scan switch for the directory 
path. When you search for a file, 
scanning allows the search to include 
higher-level SFDs and the UFD. You can 
use this switch only with the CP 
command. If you type SCAN at the 
prompt, SETSRC interprets it as 
CP[dir]/SCAN. 

Adds the SYS: specification to your 
DSK: specification. If a file cannot 
be found in your directories in your 
search list or in your library directory 
(if /LIB: [proj , prog] has been 
specified), the system directory [1,4] 
will then be searched for the file. 
This switch can be typed in directly as 
a command by omitting the C or M command 
and the slash. For example, SYS is 
equivalent to M/SYS. 

Allows writing on the file structure. 
This is the default. 



Characteristics 
The SETSRC program: 

Places your terminal at user level. 

Destroys your core image. 
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Example 

Your search list is defined as DSKB:. 

.R SETSRC<RET> 
*T<RET> 
*DSKB:, FENCE 

Add DSKA: to the end of the search list. 

*A DSKA:<RET> 

Your search list is now defined as DSKB:, DSKA:. 

*T<RET> 

DSKB: , DSKA:, FENCE 

Add DSKC: to the beginning of the search list. 

*A DSKC: ,*<RET> 

*T<RET> 

DSKC : , DSKB : , DSKA : , FENCE 
Remove DSKA: from the search list. 

*R DSKA:<RET> 

*T<RET> 

DSKC: ,DSKB: , FENCE, DSKA; 
Disable writing on DSKB:. 

*M DSKB:/NOWRITE<RET> 

Set your library directory to [27,500] and add it to your DSK: 
specification. 

*M/LIB:[27,500]<RET> 

Add SYS: to your search list. 

*SYS<RET> 

*T<RET> 

/LIB: [27,500]/SYS DSKC: , DSKB :/NOWRITE, FENCE, DSKA: 

Your DSK: and SYS: specifications are listed first, followed by your 
search list. 

*TS<RET> 

The system search list is defined as DSKA: , DSKB: , DSKC: . 

*DSKA:, DSKB:, DSKC: 
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DISPLAYING SYSTEM STATISTICS USING SYSDPY 



Function 

The SYSDPY program allows you to display system status and the status 
of network links and user jobs, formatted for your particular type of 
terminal. SYSDPY features a display-oriented output format with many 
commands for controlling the types of information to include in the 
display. 

When you first start the SYSDPY program, it displays the status of the 
user jobs and the system statistics. It is ready to receive user 
commands at any time. Your commands are not echoed on the screen, but 
are reflected in the changes in the display. 

Format 

To start the SYSDPY program, type the R command followed by the 
special version of SYSDPY that is designed for your type of terminal. 
The different version of SYSDPY and the terminal types for which they 
are designed are: 

Version Terminal 

SYSDPA DIGITAL VT05A 

SYSDPB DIGITAL VT05B (2400 baud) 

SYSDPY DIGITAL VT06 (Datapoint 3300) 

SYSVBX DIGITAL VB10C graphics display 

SYSV50 DIGITAL VT50 

SYSV52 DIGITAL VT52 

SYSV61 DIGITAL VT61 

SYSANS DIGITAL VT100 or other ANSI terminal 

SYSDLT Delta Data Telterm 

SYSHLZ Hazeltine 2000 

Any unprivileged user can run SYSDPY, but the output of certain system 
statistics is restricted to privileged jobs only. If you are logged 
in as [1,2], or your job has SPY privileges, you can use all available 
SYSDPY commands. 

When SYSDPY first starts running, it displays the normal job and 
system status (equivalent to the N command). At any time, you can 
type any of the one-letter commands described below, which change 
either the type of information displayed, or allow you to control the 
display of information. The file DOC: SYSDPY. MAN contains a full 
description of the information in the various displays. You do not 
need to press RETURN after you type a SYSDPY command. To exit from 
SYSDPY, type <CTRL/Z> or <CTRL/C>. 
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If you need help, type H. This either lists a help file 
(SYS:SYSDPY.HLP, if it exists) or prints a short listing of available 
commands. 

Commands to SYSDPY are: 

A Changes SYSDPY* s normal scroll setting to no-scroll. SYSDPY 
usually scrolls through the display, advancing one screenful 
each update pass. (Refer to the + and - commands.) 

C Displays the DECnet link status for all open links on the 
system. 

E Displays Ethernet status. This includes all Ethernet 
channels, all KLNI controllers, and enabled protocol types. 
The E command summarizes datagram traffic and the free queue 
errors. 

F Lists file system statistics for each disk unit in the system. 
This information includes I/O counts, error summaries, 
structure membership, and a summary of swapping units. 

H Lists the help text. 

I Lists incremental statistics, which are changes in certain 
values since the last update cycle. The values incremented 
are: system uptime, job runtimes, disk reads and writes, CPU 
statistics, network I/O (byte) counts, TTY I/O counts, and 
network message counts. A + (plus sign) immediately preceding 
the uptime value indicates incremental mode. 

J Lists jobs only, without any system statistics. The jobs are 
listed in columns. 

K Displays CI network information, including open paths to nodes 
on the CI network, packet transmission and reception counts, 
and port recoverable error counts. 

L Writes the contents of the screen to the file 
LPT:SYSDPY.LOG[-] . SYSDPY logs the screen each time it is 
updated. If this log file already exists, SYSDPY appends the 
new data to it. A form feed separates each screen. Typing 
<CTRL/Z> to SYSDPY closes the file. 

M Lists normal job data and an expanded memory summary showing 
both virtual and physical job memory usage. The M job display 
does not show system statistics. 

N Lists the default statistics, which include a column of job 
status information, and a column of system status information. 
Some of the system statistics listed are CPU idle and lost 
time, and available disk structures. 

Suppresses statistics from [1,2] jobs for the J, N, and M 
displays. A second command resumes display of [1,2] jobs. 

Q Lists the system queues, just as the QUEUE program does, but 
in DPY mode. This command requires GALAXY Version 4 or later. 

R Refreshes the entire screen immediately. SYSDPY automatically 
refreshes the screen at various intervals, depending on the 
terminal in use. The R command resets the automatic refresh 
counter. 
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S Changes the SYSDPY display from the default to the disk reads, 
disk writes, and the user name for all jobs listed in the N 
display. SYSDPY resumes displaying system statistics when you 
type the S command a second time. 

T Displays ANF network topology and the NCL numbers associated 
with each node. This display requires PEEK or SPY privileges. 

V Attempts to lock SYSDPY in memory and run it in a high 
priority run queue (HPQ) . In addition, SYSDPY updates the 
screen once per second, unless you previously set the update 
time to another value (using the W command) . A second V 
command clears the lock and HPQ setting, and restores the 
update time to ten seconds. If you issued a SET HPQ command 
before running SYSDPY, the V command locks the job, but 
doesn't change the HPQ. 

SYSDPY automatically clears the V state after 1000 update 
cycles, or if you issue a Q command. The system does not 
issue an error message if SYSDPY fails to lock or run in HPQ. 
This command requires LOCK or HPQ privileges. 

nW Sets the wait time between screen updates to n seconds. The 
default, update time is ten seconds, and one second for the V 
display. You may specify n as any number between and 60. 
Zero means one clock tick. If you do not specify a time, 
SYSDPY assumes the default wait time of ten seconds. 

Z Lists all known LAT servers and some LAT traffic statistics. 

\ Displays ANF network statistics. This information includes 
the number of network messages sent and received according to 
message type (such as DATA or NEIGHBORS) , a histogram of the 
data messages sent and received as a function (log base 2) of 
the data message size, and network free core usage. 

* Displays the DECnet node status for all nodes in the DECnet 
network. Use the A command to change the display from all 
network nodes to just those nodes with active links. Use the 
* command (described below) to change the display from all 
known nodes to only those nodes with which the local node has 
had contact. 

n+ Advances the screen by n lines or n jobs, depending on the 
current display. If you do not specify n, SYSDPY advances one 
screen. When you type the + command, you clear auto-scroll 
(refer to the A command) . 

n- Scrolls the screen backwards by n lines or jobs, depending on 
the current display. If you do not specify n, SYSDPY reverses 
one screen. When you type the - command, you clear 
auto-scroll (refer to the A command). 

! Displays idle jobs or DECnet nodes, depending on the current 
display. Typing the ! command again stops display of idle 
jobs or nodes. 

# Changes the listing in the "Where" column of the job display 
from the PTY number to the controlling job number of a job 
being controlled by another job. 

% Changes the listing in the "Runtime" column of the job display 
from the actual runtime to the percentage of the CPU that the 
runtime represents. 
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Eliminates certain statistics from the display. For the N 
display, the first part of the system statistics are 
eliminated, for a DECnet display, non-valid delay time nodes 
are not shown, and for the F display, error summary 
information is not included. 

<ESC> Freezes the current screen until you type another command. 

SPACE Updates the screen display immediately, but does not change 
any SYSDPY parameters. 

Characteristics 
The SYSDPY program: 

Destroys your core image. 

Requires LOGIN. 

Places your terminal at user level. 

Example 

Run SYSDPY on a VT100 terminal to examine job and system statistics. 
SYSDPY continually scrolls through this information; you can type a 
command at any time to alter the display. 



.R SYSANS<RET> 

Job Who Where What #P State Runtime 

17 10,6016 114 STECO 100 RN 00:00.80 

18 [OPR] J4 FAL 181 HS S 00:00.00 

19 [OPR] D424 NML 157 HB V 00:00.00 

20 [OPR] D424 NETMAI 58 ED 00:00.00 

21 [OPR] 31 OPR 96 HB S 00:00.00 

22 [OPR] D424 PSTHRU 14 HB S 00:00.00 

23 [OPR] D424 MIC 21 HS 00:00.00 

24 [OPR] D424 MIC 21 HS* 00:00.00 

25 30,5570 120 NETWOR 28 *C S 00:00.00 

26 [OPR] D424 DTELDR 17 HS 00:00.00 

27 [OPR] J4 FAL 185 HS 00:00.00 

28 10,6026 124 RL211A 505 *C S 00:00.00 

29 [SELF] 123 MS 326 HB 00:00.00 

30 [SELF] 126 SYSANS 24 RN+ 00:00.20 

31 30,6003 125 D6TQ3 84 *C S 00:00.00 

32 10,6026 127 DIP 37 ~C S 00:00.00 

33 30,5730 32 DTECO 455 TINV 00:00.26 

34 10,6062 121 DIRECT 66 "C S 00:00.00 

35 10,701 J13 MACRO 137 RN 00:04.88 

37 10,6062 132 DTECO 123 "CNS 00:00.00 

38 10,6036 4 STECO 171 RN 00:00.21 

52 [OPR] 115 SYSANS 19 HS+ 00:00.25 

53 [OPR] 116 OPR 96 HB S 00:00.00 



This is RN212A DEC10 TRISMP 
dd-mmm-yy hh:mm:ss UP: 01: 04: 29 

(+) ID OV LS UPTIME CTX UUO DBL CSH 
CPU0 47 00:11.36 11 139 12 
CPU1 16 00:11.35 4 54 4 
CPU2 (Not Running) 

DSKI DSKO SWPI SWPO MTAI MTAO 
CPU0 103 21 260 58 
CPU1 47 78 317 144 



ANF In: 167 Out: 787 

DCN In: 248 OUt: 199 

ETH In: 1178 Out: 151 

TTY In: 6 Out: 498 

IPCF S:0 Out: 3 

Mem:512/1965 Shr:550 JRN:5/5/32 

Use: 3052/4741 Swp: 2756/39468 ASR:.24 

KSYS:+1D10:45 HDE:19 POK:41/8 

Job: 39/100 Det:16 



Cor: 2603 

Blk:10/80=13% 

Dgm:12/2 

Cnk:1775/2660=67% 

W/P:0/0 



Struc 

BLKX 

DSKA 

AP10 

BLKK 

DSKZ 



Mnt 

10 

12 

1 

13 





Free 
16905 
7580 
120165 
111930 
554173 



Struc 

RENG 

DSKP 

DSKC 

DSKR 

BLKY 



Mnt 

2 

3 

16 

1 

8 



Free 
142420 
205510 
74240 
191120 
101535 



Now type the E command to SYSDPY to examine Ethernet status. When you 
type the command, it does not echo on your terminal. 
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Ethernet Status of RL226A DEC10 Development dd-mmm-yy hh:mm:ss UP:05:00:46 



Chan/Kont 


State i 


E-Net i 


Address 




ETH-0 


Onl 


. ine AA- 


-00-04- 


-00-6E-1C 




NI-0 


Onl 


ine AA- 


-00-03- 


-03-00-22 




NI-1 


Onl 


.ine AA- 


-00-03- 


-03-00-13 




Protocol 




State 


Kont 


User 




60-04 LAT 




Online 


NI-0 


System 




90-00 Loopback 


Onl ine 


NI-0 


System 




60-02 RmtCor 


i 


Online 


NI-0 


System 




-Inf- 




Online 




Job 17 Ctx 


1 


60-01 DNA/MOP 


Online 


NI-0 


Job 17 Ctx 


1 


60-03 DECnet 


Online 


NI-1 


System 




-Inf- 




Online 




Job 23 Ctx 


1 



DgmXmt 


DgmRcv 


35048 


107327 


34395 


100269 


653 


7058 


DgmXmt 


DgmRcv 


34365 


97026 





2 


30 


3239 











2 


653 


7058 









FQE 
5 




3 




Exit from SYSDPY by typing <CTRL/Z>. 
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Accessing tapes, 1-1 
Action commands, 1-1 

runtime commands, 1-3 

switches, 1-2 
Active search list, 11-1 
ANF network topology, 12-3 
ASCII source file comparison, 4-3 
Assembly listing, 3-1 
AUTO files, 7-1 

Backing up files, 1-1 
BACKUP 

examples, 1-8 

prompts, 1-3 
Baud rate, 6-1 
Binary 
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files, 5-1 

mode, 6-1 

transfer modes, 8-3 

Changing directory paths, 11-2 
CI network information, 12-2 
Commands 

to NFT, 6-4 

to OPSER, 7-1 

to RUNOFF, 10-1 

to SETSRC, 11-2 

to SYSDPY, 12-2 
Comparing files, 4-1 
Compressed core image files, 4-3 
Creating directories, 2-1 
CREDIR 

examples, 2-3 

switches, 2-1 
Cross-referenced listings, 3-1 

Data Access Protocol (DAP) , 6-1 
DECnet, 6-1, 12-2 
Defaults for GLOB, 5-2 
Directories, 2-1 
Directory paths, 11-2 
Disks, 9-1 

Displaying system statistics, 
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Ersatz devices, 2-1 
Ethernet, 12-2 



FENCE, 11-1 



FILCOM 

examples, 4-6 

program, 4-1 
File Access Listener (FAL) , 6-1 
File transfer, 6-1 
Flags in GLOB output, 5-3 

GLOB 

example, 5-4 

program, 5-1 
Global symbols, 5-1 

High-segment files, 4-3 

Listing global symbols, 5-1 
Local file transfer, 8-1 
Logged-in quota, 2-1 
Logged-out quota, 2-2 

MACRO label, 4-4 

Network File Transfer, 6-1 

OPSER program, 7-1 
Output 
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